home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / lo2_0514.zip / README < prev    next >
Text File  |  1996-05-14  |  11KB  |  228 lines
  1.  
  2.         ╔══════════════════════════════════════════════════════════════╗
  3.         ║        LORABBS PROFESSIONAL EDITION - VERSION 2.99.41        ║
  4.         ╚══════════════════════════════════════════════════════════════╝
  5.  
  6.         Preliminary Documentation
  7.         Version 2.99.41
  8.  
  9.         Coyright (c) 1996-97 by Marco Maccaferri. All rights reserved.
  10.  
  11.  
  12.         ╔══════════════════════════════════════════════════════════════╗
  13.         ║ INSTALLATION                                                 ║
  14.         ╚══════════════════════════════════════════════════════════════╝
  15.  
  16.         Lora will ship with a ready-to-run configuration that allows you
  17.         to plug in your modem and start you BBS system in a matter of
  18.         minutes, with minimal configuration changes (someone may call
  19.         this Plug-and-Play). 
  20.  
  21.         To install Lora, simply unpack the original distribution package
  22.         on an empty directory and type install. You must use an empty
  23.         directory, even if you are upgrading from Lora 2.4x, since the
  24.         data files are all changed but someone may have the same name,
  25.         if you install the new program over a previous installation you
  26.         may overwrite some files and you will not be able to import your
  27.         existing configuration to the new version. 
  28.  
  29.         The following files and directories will be created by the
  30.         installation program:
  31.  
  32.         inbound\            Mail inbound directory
  33.         outbound\           Mail outbound directory
  34.         msg\                Message base files
  35.         file\               File areas root directory
  36.         temp\               Temporary files directory
  37.         home\               User's home directories (private
  38.                             directories)
  39.         misc\*.*            Text files that should be displayed during
  40.                             the BBS operations
  41.         menu\*.mnu          Menu files
  42.         nodes\nodelist.dat  FidoNet nodelist data files
  43.         nodes\nodes.dat     FidoNet nodes data
  44.         config.dat          Configuration file
  45.         channel.dat         Channel configuration overrides
  46.         events.dat          Event scheduler data
  47.         file.dat            File areas data file
  48.         file.idx            File areas index file
  49.         msg.dat             Message areas data file
  50.         msg.idx             Message areas index file
  51.         limits.dat          Users limits definitions
  52.         packer.dat          Compressor definitions
  53.         protocol.dat        External file transfer protocols
  54.                             definitions
  55.         default.lng         Default (english) language file
  56.         italian.lng         Italian language file
  57.         lora.doc            Documentation (this file)
  58.         lora.exe            Main program
  59.         lmsg.exe            Message areas maintenance utility
  60.         lfile.exe           File areas maintenance utility
  61.         luser.exe           Users maintenance utility
  62.         snoop.exe           Utility to see the user's output on the
  63.                             local
  64.         comm.dll            Communication dynamic link (shared) library
  65.         lora_api.dll        Lora Application Programming Interface
  66.                             dynamic link (shared) library
  67.         msgbase.dll         Message base dynamic link (shared) library
  68.         bbs.dll             BBS dynamic link (shared) library
  69.         afxhelp.txt         Help text file for the Areafix processor.
  70.         raidhelp.txt        Help text file for the Raid processor.
  71.         so32dll.dll         32 bit socket library. You should delete
  72.                             this file if you have the TCP/IP stack
  73.                             already running on your OS/2 system.
  74.         tcp32dll.dll        32 bit TCP/IP library. You should delete
  75.                             this file if you have the TCP/IP stack
  76.                             already running on your OS/2 system.
  77.  
  78.         If this is a new installation, you need to change some default
  79.         values to your needs, before starting your BBS. You should
  80.         change the 'Global / Site informations' dialog and, if
  81.         necessary, the 'Modem / Hardware' and 'Modem / Command Strings'
  82.         dialogs. The default configuration is designed to run on the
  83.         COM2 serial port at a speed of 19200 bps and with the simple ATZ
  84.         initialisation command. Change this values to reflect your
  85.         hardware requirements. 
  86.  
  87.         If you are upgrading from a previous beta release, you must run
  88.         the update.exe program before starting Lora. If you don't find
  89.         this program in the distribution file, then it is not required
  90.         (it isn't a bug, just no data files upgrade are required). 
  91.  
  92.         You can start exploring your new BBS by issuing the 'System /
  93.         Local login' command. As a new user you are assigned the levels
  94.         defined with the 'BBS / New users' dialog. If these levels are
  95.         too low for you (as a sysop you may want to have an higher
  96.         access level), just log off and go to the 'Manager / User
  97.         editor' dialog. Your name should be the first displayed on
  98.         screen.  Change the 'Security' dialog and the 'Limits' field to
  99.         reflect your needs. 
  100.  
  101.  
  102.         ┌──────────────────────────────────────────────────────────────┐
  103.         │ Notes for Linux users                                        │
  104.         └──────────────────────────────────────────────────────────────┘
  105.  
  106.         The installation program will be extracted with not execution
  107.         permission. You should manually change that with the following
  108.         command:
  109.  
  110.         chmod a+x INSTALL
  111.  
  112.         After the installation program unpacks all the required files,
  113.         you should manually change the execution permissions for the
  114.         executable files, in order to run the program.
  115.  
  116.         The following commands should be issued from the command line:
  117.  
  118.         chmod a+x lora
  119.         chmod a+x lfile
  120.         chmod a+x lmsg
  121.         chmod a+x luser
  122.  
  123.         Starting from Lora version 2.99.41 there are no more shared
  124.         libraries. I had server reports from people trying to use the
  125.         Linux version with a lot of problems, may of them can't even
  126.         start Lora. From this version on there will be only executable
  127.         files with all needed libraries already linked in, this should
  128.         solve most of the installation problems.
  129.  
  130.         Lora for Linux can run both as a standalone program (taking full
  131.         control of the active console) or as a login daemon. By default
  132.         Lora will start as a standalone program an display the mailer
  133.         front-end screen with the log, modem output, outbound and status
  134.         windows. Using the -daemon command line switch it will start as
  135.         a daemon process with no input/output to the standard I/O
  136.         streams. Using this parameter you can add Lora to your
  137.         /etc/inittab file to be automatically started after each boot.
  138.  
  139.         For example:
  140.  
  141.         lora            - Start Lora as a standalone program.
  142.         lora -daemon    - Start Lora as a daemon process.
  143.  
  144.         Example of /etc/inittab entry:
  145.  
  146.         # BBS lines
  147.         s2:12345:respawn:/sbin/lora /home/bbs/config.dat \
  148.           /home/bbs/channel.dat \
  149.           -n1 -b38400 -p/dev/ttyS1 -daemon
  150.  
  151.         It is possible that Lora can't open the comunication device. On
  152.         some Linux systems Lora must be run as root in order to
  153.         successfully open the comunication device. If you are not logged
  154.         as root and you have problems running Lora, try to logout and
  155.         reenter as root.
  156.  
  157.  
  158.         ┌──────────────────────────────────────────────────────────────┐
  159.         │ Upgrading from Lora 2.4x                                     │
  160.         └──────────────────────────────────────────────────────────────┘
  161.  
  162.         If you have installed Lora 2.99.41 in a directory separated from
  163.         your existing Lora 2.4x installation, then you can upgrade
  164.         almost all your existing files. Otherwise, sorry...
  165.  
  166.         For this task the programs 'lcvt240.exe' and 'lcvt241.exe' area
  167.         provided. This is a very simple program, with very little error
  168.         checking, so be careful and read these notes entirely. The
  169.         program is a 16 bit DOS executable.
  170.  
  171.         'lcvt240.exe' will convert all Lora 2.40 files except the menu
  172.         files. 'lcvt241.exe' will convert all Lora 2.41 (pl59) files
  173.         except the menu files. Since this section is not yet complete in
  174.         Lora 2.99.41, the menu files can't be converted right now. A
  175.         complete conversion program will be provided with the final
  176.         release.
  177.  
  178.         'lcvt240.exe' and 'lcvt241.exe' can be started with the
  179.         following parameters:
  180.  
  181.         lcvt* <operation> <frompath> <topath>
  182.  
  183.         <operation>     Is the file conversion operation that should be
  184.                         performed. You can convert one of the following
  185.                         files:
  186.  
  187.                         msg        Message areas configuration
  188.                         file       File areas configuration
  189.                         sched      Event scheduler
  190.                         users      Users database
  191.                         limits     User limits definitions
  192.                         nodes      FidoNet nodes definitions
  193.                         echolink   Links for the echomail areas
  194.                         packers    Compressor definitions
  195.                         filelink   Links for the echofile (TIC) areas
  196.  
  197.         <frompath>      Is the path complete with the trailing backslash
  198.                         of your existing Lora 2.4x files. For example:
  199.                         c:\lora\
  200.  
  201.         <topath>        Is the path complete with the trailing backslash
  202.                         where you have installed Lora 2.99.41. For
  203.                         example: .\ for the current directory.
  204.  
  205.         Following is a batch file that can be used to completely convert
  206.         a Lora 2.4x configuration to Lora 2.99.41:
  207.  
  208.         lcvt240 msg c:\lora\ .\
  209.         lcvt240 file c:\lora\ .\
  210.         lcvt240 sched c:\lora\ .\
  211.         lcvt240 users c:\lora\ .\
  212.         lcvt240 limits c:\lora\ .\
  213.         lcvt240 nodes c:\lora\ .\nodes\
  214.         lcvt240 echolink c:\lora\ .\
  215.         lcvt240 packers c:\lora\ .\
  216.         lcvt240 filelink c:\lora\ .\
  217.  
  218.         After converting the configuration files, you can create the
  219.         filebase with the 'lfile.exe' program. Simply run the following
  220.         command:
  221.  
  222.         lfile -i
  223.  
  224.         This command will read the old files.bbs from the file areas
  225.         directories and create the filebase.dat and filebase.idx files
  226.         that can be read by Lora 2.99.41.
  227.  
  228.